PATHMac OS 8 and 9 Developer Documentation > Networking and Communications > URL Access Manager >

Transferring Files With the URL Access Manager


URLGetProperty

Gets the value of a property.

OSStatus URLGetProperty (
                     URLReference urlRef,
                     const char* property,
                     void* propertyBuffer,
                     Size bufferSize);
urlRef
A reference of type URLReference that identifies the URL that has a property whose value you want to obtain.
property
An untyped pointer to a null-terminated array of characters that specifies the name of the property whose value you want to obtain.
propertyBuffer
A pointer to a buffer. On return, buffer contains the value of the specified property.
bufferSize
A value of type Size that specifies the length of propertyBuffer in bytes. Before calling URLGetProperty , call URLGetPropertySize to make sure that propertyBuffer is big enough to hold the value that will be returned by URLGetProperty . For more information on the Size type, see Inside Macintosh: Memory .
function result
A result code. If URLGetProperty returns kURLPropertyBufferTooSmallError , your application should allocate a new buffer of the length returned by URLGetPropertySize calling URLGetProperty again. For a list of other possible result codes, see Result Codes .

DISCUSSION

Before calling URLGetProperty , call URLGetPropertySize to make sure that your buffer is big enough to hold the property value. Then specify the size of the buffer required for that property value in the bufferSize parameter.

SEE ALSO

The function URLSetProperty .


© 1999 Apple Computer, Inc. – (Last Updated 07 May 99)